package com.ruoyi.activity.service;

import java.util.List;
import com.ruoyi.activity.domain.TbUserCoupon;
import com.ruoyi.activity.domain.vo.TbUserCouponVO;

/**
 * 用户领卷记录Service接口
 * 
 * @author jll
 * @date 2025-06-13
 */
public interface ITbUserCouponService 
{
    /**
     * 查询用户领卷记录
     * 
     * @param id 用户领卷记录主键
     * @return 用户领卷记录
     */
    public TbUserCoupon selectTbUserCouponById(Long id);

    /**
     * 查询用户领卷记录列表
     * 
     * @param tbUserCouponVO 用户领卷记录
     * @return 用户领卷记录集合
     */
    public List<TbUserCouponVO> selectTbUserCouponList(TbUserCouponVO tbUserCouponVO);

    /**
     * 新增用户领卷记录
     * 
     * @param tbUserCoupon 用户领卷记录
     * @return 结果
     */
    public int insertTbUserCoupon(TbUserCoupon tbUserCoupon);

    /**
     * 修改用户领卷记录
     * 
     * @param tbUserCoupon 用户领卷记录
     * @return 结果
     */
    public int updateTbUserCoupon(TbUserCoupon tbUserCoupon);

    /**
     * 批量删除用户领卷记录
     * 
     * @param ids 需要删除的用户领卷记录主键集合
     * @return 结果
     */
    public int deleteTbUserCouponByIds(Long[] ids);

    /**
     * 删除用户领卷记录信息
     * 
     * @param id 用户领卷记录主键
     * @return 结果
     */
    public int deleteTbUserCouponById(Long id);

    /**
     * 根据用户id查询用户领券记录
     * @param id
     * @return
     */
    TbUserCoupon selectTbUserCouponByUserId(Long id);

    /**
     * 根据优惠券码查询用户领券记录
     *
     * @param couponCode
     * @return
     */
    TbUserCoupon selectTbUserCouponByCouponCode(String couponCode);
}
